home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
tex
/
dview31.zip
/
DVIEW.DOC
< prev
next >
Wrap
Text File
|
1990-01-08
|
6KB
|
132 lines
DVIEW DVI File Viewer version 3.1 Steve Ward & Ricardo Jenez 10/89
DVIEW is a program for IBM PC compatibles for viewing TeX .dvi output
files, including those using the MIT graphics extensions. Currently
DVIEW supports the CGA, EGA, VGA, and the high-resolution mode of the
Toshiba T3100 (& presumably the AT&T 6300); other displays may be
supported in time.
QUICK START: You can get DVIEW up and running, and read a TeX-formatted
version of this information, by moving PXL files from this archive
to the appropriate subdirectories, and typing "DVIEW DVIEW". To do
so without reading further (on a PC with CGA-compatible display),
type "RUNME".
OVERVIEW: DVI files are standard and machine-independent; they may
be generated on the PC or downloaded from another source. Viewing
them requires DVIEW plus a set of appropriate font files, which again
are standard Metafont output (PXL or PK) files and can be downloaded from
any of a variety of sources. DVIEW reads each page and builds a
virtual bitmap (in RAM), then blts segments onto your display as you
move around the virtual page (using arrow keys). During the building
process DVIEW shows its progress via a reduced image of the page; this
overview is recoverable by pressing "?" subsequently. The size and
shape of the virtual page, as well as a scale factor, are variable
via obscure command-line arguments (see below); they default to values
which allow most papers to just fit horizontally, requiring scrolling
only in the vertical dimension.
FONT FILES: By default, these live in a subtree /PXL on your PC. /PXL
contains subdirectories with numeric names like /PXL/480, indicating
resolution; entries in the subdirectories are PXL or PK files with names
like /PXL/480/CMR10.PXL or CMR10.PK, indicating the font. You need only to
download the specific files used by your paper -- a reasonably complete
set can run into many megabytes. To help you manage fonts, DVIEW
(1) after warning you, will try to substitute a smaller font of the
same style for any missing fonts; (2) allows you to review the font
situation using the "f" command; and (3) writes out a file "MISSING.FNT"
which indicates the additional fonts you need to download. MIT users
can do a MAKE from /archive/pxl, which accesses MISSING.FNT in the
local directory and downloads the necessary fonts. Presumably
this situation can be duplicated elsewhere; look in hx:/archive/pxl
for our local PC-appropriate font cache.
Note: As of release 3.0, designated bitmap font resolutions are 5X
smaller than the one previously used, following the convention which
seems to have changed with the advent of cm fonts; eg. what was pixel
size 480 is now 96. The old scaling can be obtained by using the "-a"
command line option as mentioned below.
PICTURES: DVIEW understands the simple M.I.T. extensions for drawing lines,
allowing pictures (created e.g. using GEDIT on the PC) in TeX
documents to be viewed. See DVIEW.DVI for a simple example.
DVIEW.TMP: Because font loading takes some time (a LOT on an old PC,
a few seconds even on the T3100) DVIEW offers the "t" command (or
"-t" command line option) to cause a dump of its fonts and parameters
into a fast-load file DVIEW.TMP. If DVIEW finds DVIEW.TMP on a
subsequent invocation, it loads it and presumably restores your
parameters (including display type) and fonts. This step is worth
taking if you will be repeatedly viewing edited versions of the same
file. You can delete DVIEW.TMP and/or make a new one at any point,
eg if you change the set of fonts you are using.
COMMAND SUMMARY: Once in DVIEW viewing a page, you can type:
? HELP information (this summary)
UP move page up
DOWN move page down
LEFT shift page left
RIGHT shift page right
HOME top of page
END bottom of page
PgUp double step size
PgDn halve step size
t write state into DVIEW.TMP
f show font list
p Print (low-res) page
<digit> enter new page number
SPACE next page
BACKSP previous page
RETURN back to page 1
TAB skip to last page
ESC return to MS-DOS
plus a few which I've probably forgotten. Poke around a little. Note
that the above info is online.
When fired up with no arguments, DVIEW gives you the following terse
command line help:
DVIEW DVI File Viewer version 3.1 Steve Ward & Ricardo Jenez
DVIEW <options> <dvifile> [version 3.1]
<options> or DVIEW envstring may include:
-x# adjusts horizontal page offset. [default: 65]
-y# adjusts vertical page offset. [40]
-R# sets resolution to # [default 96; try 80]
-F<path> sets font directory to <path> [/pxl]
-X# set virtual page X size, in BYTES. [90]
-Y# set virtual page Y size, in LINES. [1000]
-m# sets page map width to #. [300]
-dc sets display to type c (c=cga,t=T3100,e=ega, v=vga)[?]
-t writes DVIEW.TMP as font/parameter cache
-t<name> writes <name> as font/parameter cache
-a use pre version 3.0 font designation (5 times larger)
-cx# sets color (x=a, b, c, ...)
If you are wildly experimental and don't like the parameters DVIEW defaults
to, you can try some of the above. Start with "dview file" (or, on e.g. a
T3100, "dview -dt file") and play a little.
ENVIRONMENT VARIABLE: When invoked, DVIEW looks for a value bound to
the environment variable DVIEW, and interprets it as command line
options. Thus, for example, the line
set DVIEW = -de -F/tex/fonts/
in your AUTOEXEC.BAT file causes DVIEW to assume by default an EGA and
the subdirectory tree /TEX/FONTS/... for fonts.
\Section{Distribution}
DISTRIBUTION: DVIEW may be freely distributed, and used for any purpose
by anybody. If you can figure out how to make money from it despite the
fact that I'm giving it away, you're welcome to. I like the idea that
free software is free -- that is, completely unencumbered.
(end)